Skip to main content

The Access

What you need before you begin

  1. A supported web browser (Chrome, Edge, Brave or Firefox is recommended).
  2. The URL of your Sumo Ledger environment (this guide uses https://las.ledger.raralabs.dev/; yours may differ).
  3. Credentials issued by your administrator (username and password).
  4. If you cannot sign in, confirm with Administrator that the authentication service and database are healthy; Sumo Ledger depends on the backend to validate users.

Open the login page (step-by-step)

  1. Open your browser.
  2. In the address bar, type or paste: {base_url}/login
  3. Press Enter.
  4. Wait until the page title shows Sumo Ledger | API-First Ledger Engine and you see the branded header, headline, and a white login card in the center.

What you should see

  • Username label and a text field.
  • Password label and a masked text field (with a lock icon and an eye icon to show or hide the password).
  • A primary Login button.
  • Optional Learn More (top-right) for product information.

Sign in (step-by-step)

  1. Click inside the Username field.
  2. Type your username exactly as provided (no leading or trailing spaces).
  3. Click inside the Password field.
  4. Type your password. If you are unsure you typed it correctly, click the eye icon once to reveal the password, verify, then click again to hide it.
  5. Click Login.

Expected result (success)

  • A toast such as “Logged In Successfully” appears briefly.
  • The browser navigates to the Home dashboard.
  • The address bar shows: {base_url}/dashboard
  • The sidebar shows your navigation items, and the bottom of the sidebar shows your username (for example admin).

If sign-in fails

SymptomLikely causeWhat to do
Toast: invalid login credentialsWrong username/password, or account disabledRe-check credentials; reset password per your org process.
Same error with correct passwordDatabase or auth service outageAsk operations to restore the database / services; retry after confirmation.
Page spins without completingNetwork or TLS issueTry another network; check corporate proxy or firewall rules.

Learn More (optional)

  1. On the login screen, locate Learn More (top-right).
  2. Click Learn More.
  3. Follow the information or link presented (behavior depends on how your environment is wired).

Sessions, bookmarks, and “not authorized”

Sumo Ledger uses a browser session after login. If you copy a deep link (for example to {base_url}/product-accounts) and open it in a new browser window where you have not logged in, you may see:

You are not authorized to access this resource.

Recommended practice

  1. Always start from {base_url}/login, sign in, then use the sidebar to reach the area you need.
  2. If you use bookmarks, bookmark Login or Dashboard after a successful login session, not only deep configuration URLs.

User menu - profile, documentation, sign out

The user menu is opened from the username control at the bottom of the sidebar.

Step-by-step

  1. Sign in until you see the main application shell (sidebar + content).
  2. Scroll the sidebar if needed so the username row is visible.
  3. Click the username row (for example admin).
  4. A small menu opens.

Menu items

ItemDescription
HelpFor system helpline. May be disabled in some deployments.
DocumentationOpens product or API documentation.
SettingsUser-level or app settings when configured.
Sign OutEnds your session; you must sign in again to continue.

To sign out safely

  1. Open the user menu (steps above).
  2. Click Sign Out.
  3. Confirm you are returned to the login page or an unauthenticated state.
  4. On a shared computer, close the browser window after signing out.